home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / relnotes / pcp_eoe / ch3.z / ch3
Text File  |  2001-04-17  |  41KB  |  908 lines

  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        3.  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  9.  
  10.        The major additions and changes for the basic services and
  11.        tools of the Performance Co-Pilot are described in the
  12.        following sections.
  13.  
  14.        Refer to the reference pages of the individual utilities for
  15.        a complete description of any new functionality.
  16.  
  17.        3.1  _I_n_f_r_a_s_t_r_u_c_t_u_r_e__C_h_a_n_g_e_s
  18.  
  19.        The following changes have been made to the PCP
  20.        infrastructure that affect both collector and monitor
  21.        configurations.
  22.  
  23.  
  24.        3.1.1  _C_h_a_n_g_e_s__f_o_r__I_R_I_X__6_._5  The following incidents were
  25.        resolved for IRIX 6.5.8.
  26.  
  27.        768814  Resolved some diskless install problems.
  28.  
  29.        773035  The xxxxvvvvmmmm PMDA exports mirror revive state
  30.                information.
  31.  
  32.        The following incidents were resolved for IRIX 6.5.6.
  33.  
  34.        764463  A new xxxxvvvvmmmm PMDA was added to export performance
  35.                statistics from the _X_V_M volume manager.
  36.  
  37.        3.1.2  _P_C_P__2_._0__t_o__P_C_P__2_._1
  38.  
  39.          1.  To help with PCP deployments on systems running
  40.              operating systems other than IRIX, the Performance
  41.              Metrics Name Space (PMNS) has been overhauled to
  42.              remove the iiiirrrriiiixxxx....  prefix from the names of the
  43.              system-centric performance metrics, e.g.
  44.              iiiirrrriiiixxxx....ddddiiiisssskkkk....ddddeeeevvvv....rrrreeeeaaaadddd____bbbbyyyytttteeeessss has become
  45.              ddddiiiisssskkkk....ddddeeeevvvv....rrrreeeeaaaadddd____bbbbyyyytttteeeessss.  In addition to changing the
  46.              PMNS, translations are also handled dynamically in the
  47.              PCP libraries, so all clients will continue to operate
  48.              correctly using either the new or the old names.  As a
  49.              consequence no configuration files will need to be
  50.              changed, and monitoring tools will work correctly in
  51.              environments with a mixture of new and old style PMNS
  52.              deployments.
  53.  
  54.          2.  The PCP inference engine ppppmmmmiiiieeee(1) has migrated from the
  55.              _p_c_p._s_w._m_o_n_i_t_o_r subsystem to the _p_c_p__e_o_e._s_w._e_o_e
  56.              subsystem, and the licensing restrictions have been
  57.              relaxed to allow ppppmmmmiiiieeee to be used to monitor
  58.              performance on the local host without any PCP
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.              licenses.
  75.  
  76.          3.  Support for running ppppmmmmiiiieeee(1) as a daemon has been
  77.              added.  This has many similarities to the ppppmmmmccccdddd(1) and
  78.              ppppmmmmllllooooggggggggeeeerrrr(1) daemon support - ppppmmmmiiiieeee can be controlled
  79.              through the cccchhhhkkkkccccoooonnnnffffiiiigggg(1) interface, and the startup
  80.              and shutdown script, ////eeeettttcccc////iiiinnnniiiitttt....dddd////ppppmmmmiiiieeee which supports
  81.              starting and stopping multiple ppppmmmmiiiieeee instances
  82.              monitoring one or more hosts.  This is achieved with
  83.              the assistance of another script, ppppmmmmiiiieeee____cccchhhheeeecccckkkk(1) which
  84.              is similar to the ppppmmmmllllooooggggggggeeeerrrr support script
  85.              ppppmmmmllllooooggggggggeeeerrrr____cccchhhheeeecccckkkk(1).
  86.  
  87.          4.  New capabilities have been added to assist in the
  88.              estimation of PCP archive sizes.  The ----rrrr option for
  89.              ppppmmmmllllooooggggggggeeeerrrr(1) causes the size of the physical record(s)
  90.              for each group of metrics and the expected
  91.              contribution of the group to the size of the PCP
  92.              archive for one full day of collection to be reported
  93.              in the log file.  The ----ssss option to ppppmmmmdddduuuummmmpppplllloooogggg(1) will
  94.              report the size in bytes of each physical record in
  95.              the archive.
  96.  
  97.          5.  Changes to ppppmmmmllllooooggggggggeeeerrrr(1) have greatly reduced the size
  98.              of the *._m_e_t_a files created when logging metrics with
  99.              instance domains that change over time.
  100.  
  101.          6.  As an aid to creating ppppmmmmllllooooggggggggeeeerrrr configuration files,
  102.              ppppmmmmllllooooggggccccoooonnnnffff(1) is a new tool that allows selection of
  103.              groups of commonly desired metrics and customization
  104.              of ppppmmmmllllooooggggggggggggeeeerrrr configurations from a simple interactive
  105.              dialog.
  106.  
  107.        3.1.3  _P_C_P__1_._3__t_o__P_C_P__2_._0
  108.  
  109.          1.  The PCP Performance Metrics Name Space (PMNS) has
  110.              previously been local to the application wishing to
  111.              make reference to PCP metrics by name.  In PCP 2.0 the
  112.              PMNS operations are directed to the host or archive
  113.              that is the source of the desired performance metrics,
  114.              see ppppmmmmnnnnssss(4).
  115.  
  116.              The default name space is now associated with the PCP
  117.              collector host rather than PCP monitor host.  The
  118.              distributed PMNS involves changes to both the PCP
  119.              protocols between client applications and ppppmmmmccccdddd, and
  120.              the internal format of PCP archive files (the
  121.              ppppmmmmllllooooggggggggeeeerrrr(1) utility is able to write PCP archive logs
  122.              in either the old or new formats).
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.          2.  PCP monitor hosts do not require any name space files,
  141.              unless the local PCP client applications need to
  142.              connect to PCP collector hosts that have not yet been
  143.              upgraded to PCP 2.1.  The distributed PMNS is
  144.              implemented by having the name space functions of the
  145.              PCP Performance Metrics Application Programming
  146.              Interface (PMAPI) send and receive messages to and
  147.              from the collector ppppmmmmccccdddd(1), just like the other PMAPI
  148.              functions.
  149.  
  150.          3.  Full interoperability is supported for PCP 2.0, so new
  151.              PCP components will operate correctly with either new
  152.              or old PCP components.  For example, a PCP client that
  153.              connects to a PCP 1.x ppppmmmmccccdddd or attempts to process a
  154.              PCP archive created by a PCP 1.x ppppmmmmllllooooggggggggeeeerrrr will revert
  155.              to using the local PMNS.
  156.  
  157.              The following table describes the supported
  158.              interoperability between the client, ppppmmmmccccdddd(1) and PCP
  159.              archive log components of PCP 2.0 and PCP 1.x:
  160.  
  161.               ___________________________________________________
  162.                                  PCP 1.x client   PCP 2.0 client
  163.               ______________________________________________________________________________________________________
  164.                PCP 1.x _p_m_c_d           yes              yes
  165.                PCP 1.x archive        yes              yes
  166.                PCP 2.0 _p_m_c_d           yes              yes
  167.                PCP 2.0 archive         no              yes
  168.               ___________________________________________________
  169.               ||||||
  170.  
  171.  
  172.  
  173.  
  174.                                ||||||||||||
  175.  
  176.  
  177.  
  178.  
  179.                                                 ||||||
  180.  
  181.  
  182.  
  183.  
  184.                                                                  ||||||
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.          4.  The protocols between a PMDA and ppppmmmmccccdddd(1) have also
  192.              changed, through a new version of the _l_i_b_p_c_p__p_m_d_a
  193.              library.
  194.  
  195.              The following table describes the supported
  196.              interoperability between the ppppmmmmccccdddd(1) and PMDA
  197.              components of PCP 2.0 and PCP 1.x:
  198.  
  199.         ________________________________________________________________
  200.                           PCP 1.x     PCP 1.x      PCP 2.0     PCP 2.0
  201.                         daemon PMDA   DSO PMDA   daemon PMDA   DSO PMDA
  202.         ________________________________________________________________________________________________________________________________
  203.          PCP 1.x _p_m_c_d       yes         yes          no           no
  204.          PCP 2.0 _p_m_c_d       yes          no          yes         yes
  205.         ________________________________________________________________
  206.         |||||
  207.  
  208.  
  209.  
  210.                       ||||||||||
  211.  
  212.  
  213.  
  214.                                     |||||
  215.  
  216.  
  217.  
  218.                                                |||||
  219.  
  220.  
  221.  
  222.                                                              |||||
  223.  
  224.  
  225.  
  226.                                                                         |||||
  227.  
  228.  
  229.  
  230.  
  231.  
  232.          5.  Product structural changes.
  233.  
  234.              The PCP product images have been re-arranged as
  235.              follows.
  236.  
  237.                 +o _p_c_p__e_o_e contains all of the pieces that are
  238.                   common to any successful PCP installation,
  239.                   particularly for a collector system, i.e. a place
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.                                   - 4 -
  252.  
  253.  
  254.  
  255.                   where ppppmmmmccccdddd is running.
  256.  
  257.                 +o _p_c_p__e_o_e will ship in IRIX 6.5 and as part of PCP
  258.                   2.0 for earlier IRIX releases.
  259.  
  260.                 +o _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r includes the oooovvvviiiieeeewwww monitoring
  261.                   application (for monitoring the performance of
  262.                   ORIGIN systems, from SC4-PCPORIGIN) and does not
  263.                   require any PCP licenses.
  264.  
  265.                 +o _p_c_p._s_w._b_a_s_e provides the core PCP components that
  266.                   are outside _p_c_p__e_o_e.
  267.  
  268.                 +o _p_c_p._s_w._e_o_e for IRIX 6.2 or later has been
  269.                   replaced by _p_c_p__e_o_e._s_w._e_o_e (more formally the
  270.                   latter updates the former).  For IRIX 5.3,
  271.                   _p_c_p._s_w._e_o_e is almost empty, but allows for clean
  272.                   upgrades from all earlier PCP versions.
  273.  
  274.                 +o _p_c_p._s_w._m_o_n_i_t_o_r provides all of the PCP client
  275.                   tools for monitoring performance.
  276.  
  277.                 +o The other _p_c_p subsystems provide optional PCP
  278.                   components.
  279.  
  280.          6.  PCP 2.0 introduces some new extensions to the PMAPI,
  281.              mostly to accommodate the distributed PMNS and some
  282.              underlying protocol changes to support enhanced
  283.              inter-operability.  The _l_i_b_p_c_p and _l_i_b_p_c_p__p_m_d_a
  284.              libraries have been updated to version sgi2.0.  The
  285.              older versions of these libraries are still supported
  286.              and may be installed from the _p_c_p._s_w._c_o_m_p_a_t subsystem
  287.              if required for older PMDAs or customer-developed PCP
  288.              applications.
  289.  
  290.              The API has also changed in some ways related to
  291.              symbol hiding and changes in function arguments.  The
  292.              xxxxllllaaaatttteeee____ppppmmmmaaaappppiiii script in the _p_c_p__g_i_f_t_s._s_w._m_i_g_r_a_t_e
  293.              subsystem may be used to automate the bulk of the
  294.              source code translation from the 1.x version to the
  295.              2.0 version of the PMAPI, i.e. from _l_i_b_p_c_p._s_o._1 and
  296.              _l_i_b_p_c_p__p_m_d_a._s_o._1 to _l_i_b_p_c_p._s_o._2 and _l_i_b_p_c_p__p_m_d_a._s_o._2.
  297.  
  298.          7.  In the transition from PCP 1.2 to PCP 1.3, the
  299.              _l_i_b_p_c_p__l_i_t_e library was removed and the functionality
  300.              replaced by the new PPPPMMMM____CCCCOOOONNNNTTTTEEEEXXXXTTTT____LLLLOOOOCCCCAAAALLLL option to
  301.              ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxtttt(3) in _l_i_b_p_c_p.  The old _l_i_b_p_c_p__l_i_t_e
  302.              library is still available in the _p_c_p._s_w._c_o_m_p_a_t
  303.              subsystem.
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.                                   - 5 -
  318.  
  319.  
  320.  
  321.          8.  ppppmmmmLLLLooooooookkkkuuuuppppNNNNaaaammmmeeee(3) now produces an extra error code,
  322.              PPPPMMMM____EEEERRRRRRRR____NNNNOOOONNNNLLLLEEEEAAAAFFFF which means that the given name refers
  323.              to a non-leaf node in the PMNS and so no PMID can be
  324.              returned.  Previously, if a non-leaf name was given
  325.              then PPPPMMMM____EEEERRRRRRRR____NNNNAAAAMMMMEEEE would be returned.  Now the error
  326.              PPPPMMMM____EEEERRRRRRRR____NNNNAAAAMMMMEEEE means only that the name does not exist in
  327.              the name space.
  328.  
  329.          9.  The function ppppmmmmGGGGeeeettttCCCChhhhiiiillllddddrrrreeeennnnSSSSttttaaaattttuuuussss(3) was added to the
  330.              PMAPI.  It was introduced mainly to satisfy a new need
  331.              of ppppmmmmcccchhhhaaaarrrrtttt(1).  As well as getting the names of all
  332.              the children nodes, ppppmmmmGGGGeeeettttCCCChhhhiiiillllddddrrrreeeennnnSSSSttttaaaattttuuuussss returns a
  333.              parallel array of the status of each node, indicating
  334.              if it is a leaf or non-leaf node.
  335.  
  336.         10.  A new (much smaller) format for PMDA help text files
  337.              has been implemented, with support in the _l_i_b_p_c_p__p_m_d_a
  338.              library and the nnnneeeewwwwhhhheeeellllpppp(1) utility.
  339.  
  340.         11.  A ----LLLL option was added to ppppmmmmdddduuuummmmpppplllloooogggg(1) to produce a
  341.              more verbose variant of ----llll and report all of the
  342.              details from a PCP archive label.
  343.  
  344.         12.  ppppmmmmllllooooggggggggeeeerrrr(1) uses the additional ppppmmmmccccdddd state change
  345.              information to embed "mark" records in PCP archives
  346.              when new PMDAs are started by ppppmmmmccccdddd.  During replay,
  347.              this prevents interpolation of values in the PCP
  348.              archive across the life of an old and a new instance
  349.              of the same PMDA.
  350.  
  351.         13.  The temporal index file (``.index'' suffix) is
  352.              optional when PCP archives are being replayed.
  353.  
  354.         14.  Changes to track the object format of the booted IRIX
  355.              kernel, briefly:
  356.  
  357.                 +o ``MACH'' tag key PCP binaries in the images to
  358.                   ensure installation of o32, n32 or n64 versions
  359.                   as appropriate, based upon the installation
  360.                   platform and the IRIX version.
  361.  
  362.                 +o Only one version of the ppppmmmmccccdddd binary will be
  363.                   installed, now in /_u_s_r/_e_t_c/_p_m_c_d.
  364.  
  365.                 +o A new ppppmmmmoooobbbbjjjjssssttttyyyylllleeee(1) command is used to determine
  366.                   the appropriate kernel object style at run time
  367.                   as required, e.g. when ppppmmmmccccdddd(1) is attaching a DSO
  368.                   PMDA.
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.                                   - 6 -
  384.  
  385.  
  386.  
  387.        3.2  _C_o_l_l_e_c_t_o_r__C_h_a_n_g_e_s
  388.  
  389.        The following changes effect PMCD and the PMDAs that provide
  390.        the collection services.
  391.  
  392.  
  393.        3.2.1  _L_i_b_i_r_i_x_p_m_d_a__C_h_a_n_g_e_s__f_o_r__I_R_I_X__6_._5
  394.  
  395.        No significant _l_i_b_i_r_i_x_p_m_d_a changes were made for IRIX 6.5.7
  396.        or 6.5.8.
  397.  
  398.        The following incidents were resolved for IRIX 6.5.6.
  399.  
  400.        764170  _L_i_b_i_r_i_x_p_m_d_a was updated to support Fiber Channel
  401.                disks by converting it to use _l_i_b_d_i_s_k to access the
  402.                disk information.  In this process support for the
  403.                metric hhhhiiiinnnnvvvv....ddddiiiisssskkkk____ssssnnnn (disk serial numbers) was
  404.                withdrawn (the metric is still defined, but no
  405.                values are avaliable), because:
  406.  
  407.                  1.  Some disks don't have serial numbers or don't
  408.                      respond to SCSI requests for their serial
  409.                      number, so the set of disks associated with
  410.                      this metric was sometimes fewer than the
  411.                      number of installed disks and hence the number
  412.                      of disks reported for the other ddddiiiisssskkkk....ddddeeeevvvv....****
  413.                      metrics.
  414.  
  415.                  2.  The previous method never worked for Fiber
  416.                      Channel disks.
  417.  
  418.                  3.  _l_i_b_d_i_s_k does not provide any way of extracting
  419.                      serial numbers.
  420.  
  421.        The following incidents were resolved for IRIX 6.5.5.
  422.  
  423.        649767  Added a cluster of metrics (ssssttttrrrreeeeaaaammmm....*) for streams
  424.                data, which is also exported by nnnneeeettttssssttttaaaatttt ----mmmm.
  425.  
  426.        682896  The semantics of the metrics of
  427.                xxxxbbbboooowwww....{ppppoooorrrrtttt|ttttoooottttaaaallll}....{ssssrrrrcccc|ddddsssstttt} have changed from
  428.                reporting transfer of bytes to transfer of
  429.                micropackets as it is impossible to tell how many
  430.                bytes of data are really transferred.
  431.  
  432.        The following incidents were resolved for IRIX 6.5.4.
  433.  
  434.        675673  Added metrics xxxxffffssss....iiiifffflllluuuusssshhhh____ccccoooouuuunnnntttt and
  435.                xxxxffffssss....iiiicccclllluuuusssstttteeeerrrr____fffflllluuuusssshhhhzzzzeeeerrrroooo which export xfs inode
  436.                cluster statistics.
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.                                   - 7 -
  450.  
  451.  
  452.  
  453.        The following incidents were resolved for IRIX 6.5.3.
  454.  
  455.        628012  Added wait I/O metrics
  456.                kkkkeeeerrrrnnnneeeellll....{aaaallllllll|ppppeeeerrrrccccppppuuuu}....wwwwaaaaiiiittttiiiioooo....qqqquuuueeeeuuuueeee and
  457.                kkkkeeeerrrrnnnneeeellll....{aaaallllllll|ppppeeeerrrrccccppppuuuu}....wwwwaaaaiiiittttiiiioooo....oooocccccccc to allow the
  458.                calculation of the new ssssaaaarrrr ----qqqq fields of wwwwiiiiooooqqqq----sssszzzz and
  459.                %%%%wwwwiiiioooooooocccccccc.
  460.  
  461.        The following incidents were resolved for IRIX 6.5.2.
  462.  
  463.        558773  Added metrics for the instantaneous disk queue
  464.                length and for the running sum of the disk queue
  465.                lengths.
  466.  
  467.        The following incidents were resolved for IRIX 6.5.1.
  468.  
  469.        588158  A section called "Enabling of Statistics Collection"
  470.                has been added to the lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa(5) man page.
  471.  
  472.        603178  Extra diagnostic messages were added to log the
  473.                state changes of turning the xlv statistics
  474.                gathering on or off.
  475.  
  476.  
  477.        3.2.2  _P_C_P__2_._0__t_o__P_C_P__2_._1
  478.  
  479.          1.  The pppprrrroooocccc agent has been changed to use
  480.              /_p_r_o_c/_p_i_n_f_o/_x_x_x_x if possible and only use /_p_r_o_c/_x_x_x_x
  481.              if there is no alternative.  Previously this agent
  482.              always used /_p_r_o_c/_x_x_x_x to extract process information,
  483.              and this caused unnecessary access checking to take
  484.              place and some NFS contention problems were reported
  485.              as a result.
  486.  
  487.          2.  The new eeeessssppppppppiiiinnnngggg PMDA provides quality of service
  488.              metrics for consumption by the Embedded Support
  489.              Partner (ESP) infrastructure (released in IRIX 6.5.5).
  490.              This PMDA can be used in conjunction with ppppmmmmiiiieeee(1)
  491.              rules generated by the new ppppmmmmiiiieeeeccccoooonnnnffff(1) tool to detect
  492.              service failure on either local or remote hosts.
  493.              Among the services which can be probed are ICMP, SMTP,
  494.              NNTP, ppppmmmmccccdddd, and local HIPPI interfaces using the new
  495.              hhhhiiiipppppppprrrroooobbbbeeee(1) utility.
  496.  
  497.          3.  Changes to the way ppppmmmmccccdddd(1) and ppppmmmmllllooooggggggggeeeerrrr(1) are started
  498.              from ////eeeettttcccc////iiiinnnniiiitttt....dddd////ppppccccpppp.
  499.  
  500.                a.  When ppppmmmmllllooooggggggggeeeerrrr is chkconfig'd oooonnnn, ppppmmmmllllooooggggggggeeeerrrr
  501.                    instances are launched in the background from
  502.                    ////eeeettttcccc////iiiinnnniiiitttt....dddd////ppppccccpppp ssssttttaaaarrrrtttt, as this helps faster
  503.                    system reboots.  In some cases this results in
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.                                   - 8 -
  516.  
  517.  
  518.  
  519.                    diagnostics from ppppmmmmllllooooggggggggeeeerrrr and/or
  520.                    ////uuuussssrrrr////ppppccccpppp////bbbbiiiinnnn////ppppmmmmllllooooggggggggeeeerrrr____cccchhhheeeecccckkkk that previously
  521.                    appeared when ////eeeettttcccc////iiiinnnniiiitttt....dddd////ppppccccpppp was run to now be
  522.                    generated asynchronously - any such messages are
  523.                    forwarded to the rrrrooooooootttt user as e-mail.  These
  524.                    messages are in addition to those already
  525.                    written to /_v_a_r/_a_d_m/_p_c_p/_N_O_T_I_C_E_S by ppppmmmmppppoooosssstttt(1)
  526.                    from ////eeeettttcccc////iiiinnnniiiitttt....dddd////ppppccccpppp.
  527.  
  528.                b.  A new utility, ppppmmmmccccdddd____wwwwaaaaiiiitttt(1), provides a more
  529.                    reliable mechanism for detecting that ppppmmmmccccdddd is
  530.                    ready to accept client connections.
  531.  
  532.          4.  In concert with changes to ppppmmmmiiiieeee, the ppppmmmmccccdddd PMDA has
  533.              been extended to export information about executing
  534.              ppppmmmmiiiieeee instances and their progress in terms of rule
  535.              evaluations and action execution rates.  Refer to the
  536.              ppppmmmmccccdddd....ppppmmmmiiiieeee....****  metrics.
  537.  
  538.        3.2.3  _P_C_P__1_._3__t_o__P_C_P__2_._0
  539.  
  540.          1.  ppppmmmmccccdddd(1) has been modified to support the distributed
  541.              name space.  This has meant the following changes:
  542.  
  543.                 +o ppppmmmmccccdddd(1) now loads the default name space on
  544.                   startup or an alternative name space if specified
  545.                   by ----nnnn.
  546.  
  547.                 +o On a SIGHUP signal it will reload the name space
  548.                   if it has been modified since the last load time.
  549.  
  550.                 +o ppppmmmmccccdddd(1) responds to name space PDU requests using
  551.                   its local name space.
  552.  
  553.          2.  ppppmmmmccccdddd(1) no longer requires a PCP collector license to
  554.              start, however connections will be refused for most
  555.              PCP clients unless the PCP collector license is
  556.              installed and valid.  Some clients (most notably
  557.              oooovvvviiiieeeewwww(1)) can connect to ppppmmmmccccdddd independent of any PCP
  558.              licenses.  To support this, the client-pmcd connection
  559.              protocols have been extended.
  560.  
  561.          3.  Support has been added for multiple protocol versions
  562.              for the client-pmcd IPC and the interaction between
  563.              ppppmmmmccccdddd and the PMDAs.
  564.  
  565.          4.  The logic used by ppppmmmmccccdddd for locating DSO PMDAs of the
  566.              correct object format has been reworked.
  567.  
  568.          5.  The diagnostic event tracing options of ppppmmmmccccdddd have been
  569.              extended to include an "unbuffered" mode where every
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.                                   - 9 -
  582.  
  583.  
  584.  
  585.              event is reported as it happens, as opposed to
  586.              buffering events in a ring buffer and only reporting
  587.              on errors and in response to explicit requests.
  588.  
  589.          6.  The distributed PMNS changes mean that ppppmmmmccccdddd must load
  590.              and export the PMNS in response to requests from
  591.              client applications.  ppppmmmmccccdddd's SIGHUP processing has
  592.              been extended to include reloading the PMNS if the
  593.              external PMNS file has been modified.
  594.  
  595.          7.  In concert with a change to ppppmmmmFFFFeeeettttcccchhhh in _l_i_b_p_c_p, ppppmmmmccccdddd is
  596.              now able to export out-of-band information about ppppmmmmccccdddd
  597.              state changes (specifically PMDA add, drop and
  598.              restart) back to client applications.
  599.  
  600.        3.3  _M_o_n_i_t_o_r__C_h_a_n_g_e_s
  601.  
  602.        The major additions and changes for the performance
  603.        visualization and analysis tools are described below.
  604.  
  605.  
  606.        3.3.1  _C_h_a_n_g_e_s__f_o_r__I_R_I_X__6_._5  The following incidents were
  607.        resolved for IRIX 6.5.8.
  608.  
  609.        776214  Better handling of error return codes for _t_e_l_n_e_t
  610.                commands used by the eeeessssppppppppiiiinnnngggg and sssshhhhppppiiiinnnngggg PMDAs.
  611.  
  612.        781065  The generic ppppmmmmiiiieeee rules supported by ppppmmmmiiiieeeeccccoooonnnnffff have
  613.                been extended to allow alarm notification to be
  614.                passed to EnlightenDSM.
  615.  
  616.  
  617.        3.3.2  _P_C_P__2_._0__t_o__P_C_P__2_._1
  618.  
  619.          1.  ppppmmmmiiiieeee
  620.  
  621.                a.  A syntactic restriction in the specification
  622.                    language has been relaxed, and actions may now
  623.                    have an arbitrary number of quoted arguments
  624.                    (previously at most two arguments were allowed).
  625.                    At the same time a problem with the ssssyyyysssslllloooogggg
  626.                    action was resolved, allowing the ----pppp option to
  627.                    be passed to llllooooggggggggeeeerrrr(1).  For example, this is
  628.                    now valid:
  629.                        some_inst (
  630.                            (100 * filesys.used / filesys.capacity) > 98 )
  631.                        -> syslog "-p daemon.info 'file system close to full"
  632.                                      " %h:[%i] %v% " "'";
  633.  
  634.                b.  Metrics with dynamic instance domains are now
  635.                    correctly handled by ppppmmmmiiiieeee.  Previously ppppmmmmiiiieeee
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.                                   - 10 -
  648.  
  649.  
  650.  
  651.                    instantiated the instance domain when it
  652.                    started, and was oblivious to any subsequent
  653.                    changes in the instance domain.  This is most
  654.                    useful for rules using the metrics of the
  655.                    hhhhoooottttpppprrrroooocccc PMDA that is part of the ppppccccpppp product.
  656.  
  657.                c.  The ppppmmmmiiiieeee language has been extended to allow two
  658.                    new operators mmmmaaaattttcccchhhh____iiiinnnnsssstttt and nnnnoooommmmaaaattttcccchhhh____iiiinnnnsssstttt that
  659.                    take a regular expression and a boolean
  660.                    expression.  The result is the boolean AND of
  661.                    the expression and the result of matching (or
  662.                    not matching) the associated instance name
  663.                    against the regular expression.
  664.  
  665.                    For example, this rule evaluates error rates on
  666.                    various 10BaseT Ethernet network interfaces
  667.                    (e.g. ecN, etN or efN):
  668.                        some_inst
  669.                            match_inst "^(ec|et|ef)"
  670.                                     network.interface.total.errors > 10 count/sec
  671.                        -> syslog "Ethernet errors:" " %i";
  672.                    The following rule evaluates available free
  673.                    space for all filesystems except the root
  674.                    filesystem:
  675.                        some_inst
  676.                            nomatch_inst "/dev/root"
  677.                                     filesys.free < 10 Mbytes
  678.                        -> print "Low filesystem free (Mb):" " [%i]:%v";
  679.  
  680.                d.  During rule evaluation, ppppmmmmiiiieeee keeps track of the
  681.                    expected number of rule evaluations, number of
  682.                    rules actually evaluated, the number of
  683.                    predicates that are true and false, the number
  684.                    of actions executed, etc.  These statistics are
  685.                    maintained as binary data structures in the
  686.                    mmmmmmmmaaaapppp'ed files /_v_a_r/_t_m_p/_p_m_i_e/<_p_i_d>.  If ppppmmmmiiiieeee is
  687.                    running on a system with a PCP collector
  688.                    deployment, the ppppmmmmccccdddd PMDA exports these metrics
  689.                    via the new ppppmmmmccccdddd....ppppmmmmiiiieeee....****  group of metrics.
  690.  
  691.                e.  Some restrictions on the expansion of macros
  692.                    (e.g. $name) have been removed, so macro
  693.                    expansion can occur anywhere in the ppppmmmmiiiieeee rule
  694.                    specifications.
  695.  
  696.                f.  There has been some changes to improve the
  697.                    formatting of numeric values reported with the
  698.                    options ----vvvv, ----VVVV and ----WWWW, and for the expansion of
  699.                    %%%%vvvv in actions.  In general terms these have
  700.                    removed extra white space and reduced the
  701.                    likelihood of scientific notation being used.
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.                                   - 11 -
  714.  
  715.  
  716.  
  717.          2.  A set of parameterized ppppmmmmiiiieeee rules have been developed
  718.              which are applicable to most systems and will allow
  719.              ppppmmmmiiiieeee to be used by new users without knowledge of the
  720.              ppppmmmmiiiieeee syntax.  A new utility, ppppmmmmiiiieeeeccccoooonnnnffff(1) has been
  721.              built which allows these rules to be enabled or
  722.              disabled, or the parameters and thresholds adjusted
  723.              for a specific system.
  724.  
  725.              The combination of ppppmmmmiiiieeee, ppppmmmmiiiieeeeccccoooonnnnffff, ppppmmmmiiiieeee____cccchhhheeeecccckkkk and
  726.              ////eeeettttcccc////iiiinnnniiiitttt....dddd////ppppmmmmiiiieeee provides the infrastructure required
  727.              for PCP to search for behavior indicative of
  728.              performance problems in a fully automated manner with
  729.              little or no local customization required.  Where
  730.              customization is needed, ppppmmmmiiiieeeeccccoooonnnnffff(1) provides a
  731.              convenient way of doing this.
  732.  
  733.          3.  A new utility, hhhhiiiipppppppprrrroooobbbbeeee(1), has been added which will
  734.              check the status of HIPPI interfaces on a system.
  735.              More sophisticated monitoring of HIPPI interfaces will
  736.              be supported with a hhhhiiiippppppppiiii PMDA that will be released
  737.              as part of the forthcoming PCP for HPC add-on product.
  738.  
  739.        3.3.3  _P_C_P__1_._3__t_o__P_C_P__2_._0
  740.  
  741.          1.  Monitor applications no longer use the local default
  742.              name space to get PMIDs for metric names unless the
  743.              name space file is explicitly given as a ----nnnn option or
  744.              the target ppppmmmmccccdddd, specified by ----hhhh, is a lower revision
  745.              than PCP 2.1.  Monitor applications use the
  746.              distributed name space by sending PDU requests to
  747.              ppppmmmmccccdddd.
  748.  
  749.          2.  To convert an existing user-written monitor
  750.              application to use the distributed name space, the
  751.              following must be done:
  752.  
  753.                 +o Only call ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) in the case of being
  754.                   given a ----nnnn option to specify a particular name
  755.                   space file.  If one only wants to use the
  756.                   distributed name space then the call to
  757.                   ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) can be deleted altogether.  As
  758.                   soon as ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) is called, the
  759.                   application is in local name space mode.
  760.  
  761.                 +o All calls to the PMAPI name space functions must
  762.                   be made in a current PMAPI context.  Previously,
  763.                   since a context was not used to service name
  764.                   space functions, it was possible to call these
  765.                   functions before any new context was created.
  766.                   Now, if there is no current PMAPI context and
  767.                   ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) has not previously been called
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.                                   - 12 -
  780.  
  781.  
  782.  
  783.                   when a name space function is called an error
  784.                   code will be returned.
  785.  
  786.                 +o The calls to the PMAPI name space functions (in
  787.                   distributed mode) will take longer to execute (as
  788.                   they must send/receive a PDU to/from a remote
  789.                   ppppmmmmccccdddd).  This means that the name space calls
  790.                   should not be made unnecessarily.
  791.  
  792.                 +o All name space calls should be tested for
  793.                   failure.  This was, of course, always the case,
  794.                   but previously there was more chance that one
  795.                   could get away without testing some calls for
  796.                   failure. However, now, every call could have some
  797.                   failure due to problems with sending or receiving
  798.                   a PDU.
  799.  
  800.          3.  The oooovvvviiiieeeewwww(1) application for monitoring Origin 200 and
  801.              Origin 2000 systems has migrated from the SC4-
  802.              PCPORIGIN product and is now included in the
  803.              _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r subsystem.  This application is
  804.              unlicensed and will operate with an unlicensed
  805.              ppppmmmmccccdddd(1).
  806.  
  807.          4.  Many of the GUI PCP tools have been integrated into
  808.              the IRIX Interactive Desktop environment, including
  809.              launch by icon, drag-n-drop behavior for hosts or
  810.              archives dropped onto PCP tools and a new ppppmmmmrrrruuuunnnn(1)
  811.              command to support optional command line arguments for
  812.              PCP tools launched from the desktop.
  813.  
  814.          5.  A PPPPeeeerrrrffffTTTToooooooollllssss page in the Icon Catalog has been created
  815.              for launching PCP tools.
  816.  
  817.          6.  The handling of error messages for both GUI and
  818.              command-line invocations of most tools has been
  819.              unified and made more consistent.
  820.  
  821.          7.  The ppppmmmmttttiiiimmmmeeee(1) application that provides time control
  822.              services to other PCP tools has been enhanced in a
  823.              number of ways:
  824.  
  825.                 +o A new Archive Time Bounds dialog (available only
  826.                   in archive mode) allows time window bounds to be
  827.                   constrained or expanded at run-time (particularly
  828.                   useful when replaying archives that are still
  829.                   growing).
  830.  
  831.                 +o Extensions to the ppppmmmmttttiiiimmmmeeee client protocol to allow
  832.                   clients to force VCR state changes and alter the
  833.                   time window bounds.
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.                                   - 13 -
  846.  
  847.  
  848.  
  849.                 +o The ppppmmmmttttiiiimmmmeeee protocol is nnnnooootttt backwards compatible
  850.                   with the PCP 1.x implementation, but all clients
  851.                   of ppppmmmmttttiiiimmmmeeee are re-released with the images on the
  852.                   PCP 2.0 CD and both ppppmmmmttttiiiimmmmeeee and its clients
  853.                   execute on the same system.
  854.  
  855.          8.  The ppppmmmmkkkkssssttttaaaatttt(1) command has been restructured in the
  856.              wake of _l_i_b_p_c_p__l_i_t_e's demise, and in particular a new
  857.              ----LLLL option supports stand alone use without ppppmmmmccccdddd(1).
  858.  
  859.        3.4  _F_e_a_t_u_r_e_s__R_e_m_o_v_e_d__o_r__D_e_p_r_e_c_a_t_e_d
  860.  
  861.        In PCP 2.1, the following features from earlier PCP versions
  862.        have been removed or are deprecated.
  863.  
  864.        3.4.1  _P_C_P__1_._3__t_o__P_C_P__2_._0
  865.  
  866.          1.  The original intent in the Performance Co-Pilot
  867.              framework was to support seamless VCR-replay between a
  868.              current ``live'' source and a recently created archive
  869.              source.
  870.  
  871.              In practice, the semantic and operational difficulties
  872.              associated with transitions between ``live'' and
  873.              ``archive'' modes are so significant that the feature
  874.              has been abandoned.
  875.  
  876.              Earlier PCP releases included a ``stubbed-out''
  877.              application ppppmmmmvvvvccccrrrr(1) that did not really do anything
  878.              and assorted infrastructure ``hooks''.  These have
  879.              been removed.
  880.  
  881.          2.  _l_i_b_p_c_p__l_i_t_e._s_o - replaced by PPPPMMMM____CCCCOOOONNNNTTTTEEEEXXXXTTTT____LLLLOOOOCCCCAAAALLLL The
  882.              standalone (without ppppmmmmccccdddd) library _l_i_b_p_c_p__l_i_t_e._s_o has
  883.              been replaced by the PPPPMMMM____CCCCOOOONNNNTTTTEEEEXXXXTTTT____LLLLOOOOCCCCAAAALLLL option to the
  884.              ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxtttt(3) routine.
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.